home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / satctl.z / satctl
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ssssaaaattttoooonnnn((((2222))))                                                              ssssaaaattttoooonnnn((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      saton, satoff, satstate - control the collection of audit data
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssaaaatttt....hhhh>>>>
  13.      iiiinnnntttt ssssaaaattttoooonnnn ((((iiiinnnntttt eeeevvvveeeennnnttttttttyyyyppppeeee))));;;;
  14.      iiiinnnntttt ssssaaaattttooooffffffff ((((iiiinnnntttt eeeevvvveeeennnnttttttttyyyyppppeeee))));;;;
  15.      iiiinnnntttt ssssaaaattttssssttttaaaatttteeee ((((iiiinnnntttt eeeevvvveeeennnnttttttttyyyyppppeeee))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _s_a_t_o_n switches
  19.       oooonnnn ccccoooolllllllleeeeccccttttiiiioooonnnn ooooffff aaaauuuuddddiiiitttt rrrreeeeccccoooorrrrddddssss ooooffff tttthhhheeee ssssppppeeeecccciiiiffffiiiieeeedddd eeeevvvveeeennnntttt ttttyyyyppppeeee....
  20.  
  21.      _s_a_t_o_f_f switches
  22.       ooooffffffff ccccoooolllllllleeeeccccttttiiiioooonnnn ooooffff aaaauuuuddddiiiitttt rrrreeeeccccoooorrrrddddssss ooooffff tttthhhheeee ssssppppeeeecccciiiiffffiiiieeeedddd eeeevvvveeeennnntttt ttttyyyyppppeeee....
  23.  
  24.      _s_a_t_s_t_a_t_e reports whether the audit subsystem is currently collecting or
  25.      discarding records of the event type specified.
  26.  
  27.      To modify or query the audit state for every event type, call _s_a_t_o_n,
  28.      _s_a_t_o_f_f, or _s_a_t_s_t_a_t_e repeatedly, once for each valid event type.
  29.  
  30. EEEERRRRRRRROOOORRRRSSSS
  31.      _s_a_t_o_n, _s_a_t_o_f_f and _s_a_t_s_t_a_t_e fail if one or more of the following
  32.      conditions are true:
  33.  
  34.      [ENOPKG]       Audit is not configured on this system.
  35.  
  36.      [EPERM]        The caller does not have CCCCAAAAPPPP____AAAAUUUUDDDDIIIITTTT____CCCCOOOONNNNTTTTRRRROOOOLLLL capability.
  37.  
  38.      [EDOM]         The specified audit event type is not valid.  Valid event
  39.                     type numbers range from 1 to SAT_NTYPES-1, inclusive.
  40.  
  41. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  42.      For _s_a_t_s_t_a_t_e, a non-zero (positive) return value indicates that the audit
  43.      subsystem is collecting records.  A return value of 0 indicates that the
  44.      audit subsystem is discarding records.  A return value of -1 indicates an
  45.      error and _e_r_r_n_o is set to indicate the error.
  46.  
  47.      For _s_a_t_o_n and _s_a_t_o_f_f, a return value of -1 indicates an error and _e_r_r_n_o
  48.      is set to indicate the error.  Otherwise 0 is returned.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      satread(2), satwrite(2)
  52.  
  53. OOOORRRRIIIIGGGGIIIINNNN
  54.      Silicon Graphics, Inc.
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.